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HARDHELP 



HARDHELP Is a test and diagnostic program for all DMS hard disk 
products and Is designed to run under DDT control. HARDHELP allows 
the user to read or write the disk, examine the buffers, and run 
various disk tests. It Is generally used for testing and trouble 
shooting but it can also be used to format the entire disk for CPM 
operation and to examine and modify the defective sector table. 

To use HARDHELP, boot up on a CP/M diskette and type DDT space, 
HARDHELP.COM then carriage RETURN. DDT will prompt the user with a 
"-" when HARDHELP Is ready to be run. Type GlOO to Initialize the 
diagnostic. HARDHELP will ask the size and type of disk drive being 
used. Next it will ask what operation the user wishes to perform. 
Answer "0" (return to DDT) as the other options are designed to be run 
without DDT control and return back to CP/M when finished. When 
control has returned to DDT {"-" prompt) type GlOO to get a menu of 
the available diagnostic routines. Use this programm carefully on a 
"live" disk as many of the test (such as format) will destroy data. A 
sample of a HARDHELP menu is given below. 



DMS HARD DISK TEST PROGRAM VER DSC3 2.37 

THE FOLLOWING ENTRY POINTS ARE IMPEMENTED 

lOOH PRINT THIS MESSAGE 

104H SETUP INTERRUPTS FOR USE WITH DDT 

108H RESET HDC4000 

lOCH ABSOLUTE SECTOR READ 

llOH ABSOLUTE SECTOR WRITE 

114H VERIFY READ ENTIRE DISK 

118H FORMAT ENTIRE DISK 

IICH LOAD HDC RAM PROGRAM 

120H RUN WRITE, READ, COMPARE TEST 

124H RUN SEEK TEST 

128H GET DISK SIZE 

12CH INITIALIZE USER AREA FROM lOOOH 

130H RUN INTERFACE TEST 

134H RUN MEMORY TEST 

138H GET CONTENTS OF HDC MEMORY 

13CH REPEAT READ THS 

140H REPEAT TEST THS 

144H SEND COMMAND 40H TO CONTROLLER 



DATA AND COMMAND BUFFERS 



The above test entry points use the following memory locations for 
data and command buffers. 

1000H-1400H WBUFFER: Data in this buffer is transferred to the hard 
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1800H-1C00H 
20H-27H 



disk on a write command. 

RBUFFER: Data that Is read from the disk Is stored In this 
buffer on disk read commands. 

COMMBUFF: This buffer 1s loaded and transmitted to the HDC 
on every HDC command. The HDC decodes the command 
buffer and acts on the Information contained therein. 
Location 20H Is loaded with the command byte. The rest 
of the buffer Is loaded from location 0F00-0F06. These 
locations specify the disk location (track, head, 
sector), number of retries, and whether to perform a 
read after write check on a write command. Note 

that this command buffer 1s prepared automatically 

by the various tests. 



COMMANDS AND COMMAND FORMAT 



The HDC commands that are loaded Into 20H of the COMMBUFF by the 
various test programs are as follows. 



ABSRDC0MM=1 

ABSWRTC0MM=2 

INITUSER=3 



TSTINT=6 
REREAD=7 

MTEST=8 
HDF0RMAT=9 



Absolute read command 

Absolute write command 

Loads the HDC user RAM area from locations 
lOOOH. User programs can be special purpose test 
programs designed operate specific parts of HDC 
hardware. The user RAM area of the HOC starts at 
4100H, therefore all user programs should be designed 
to run at 4100H. 

This causes the HDC program to run at 4100H 
where the user program HDCIT.HEX should be stored. 

Causes the HDC to run at 4100H. HDCIT.HEX 

should be at this location. Two of the entry point 

programs use this HDC command. 

Causes a memory test program to run at 4100H. 

Causes a disk format program to run at 4100H. 



Memory locations 0F00H-0F06H contain the disk location and the 
number of retries. HARDHELP programs manipulate these locations 
before loading them into COMMBUFF. The user may also manipulate these 
locations. For example If the user wished to see the contents of the 
bad sector table all he would have to do is change track, head, and 
sector to 0,0, IIH respectively and perform a disk read (GlOC). The 
contents of the RBUFFER would then contain the bad sector table. 
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The meaning of F00-F06 1s given below. 



OFOO=Track 

0F01=Head 

0F02=Sector 

0F03=Tag -not used 

0F04=Tag 1 -not used 

0F05=Retrys -number of retries + 1 . msb=l means use ECC 

capability on CRC errors for a read sector 
command, or It means perform read after write 
check for a write sector command. 

0F06=0 



DESCRIPTION OF ALL ENTRY POINT TESTS 



To perform any of the tests contained In HARDHELP simply type GNNN 
then carriage RETURN, where NNN Is the test entry location. All test 
programs return to DDT through a RST 06 or a manual Interrupt. 
Several of the tests require a manual Interrupt for a termination of 
the test and a return to DDT. The manual Interrupt switch Is the 
middle of the three switches on the front panel of the machine. Most 
tests terminate when an "R" Is typed and show a summary when an "S" Is 
typed. 

GlOO -Display the directory of all entry points 

6104 -Enables the front panel Interrupt ON DSC2 ONLY 

G108 -Resets the HDC See HOC OPERATION DESCRIPTION 

for a detailed description of a reset. (Note that GlOO 
"falls through" and executes a G104 and G108). 

GIOC -Reads the sector specified by track, head, and sector 
For detailed description see HDC OPERATION DESCRIPTION 

GUO -Writes the sector specified by track, head, sector. 

For detailed description see HDC OPERATION DESCRIPTION 

GUC -This program loads the HDC user area from lOOOH. It Is 
Intended that the user programs will be test programs. 

G114 -This Is a read test. It reads all sectors on the disk 
and reports any read errors. 

G118 -This test formats the entire disk. It destroys all 

data on the disk. The program asks the user whether or 
not he wishes to continue. The first 17 IK blocks 
of the disk will be saved and restored. 



G120 -This Is a complete disk test. It writes and reads 

contlnously over all sectors on the disk exept for track 
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0. Two types of patterns are used; a cycllcly 

rotated B6D9 pattern, and a random pattern. 

G120 reports write errors, read errors 

and compare errors. An error counter at F08 

counts the number of errors. Return throuqh front 

panel interrupt or "R". Typinq an 'S' whilo tho pronrnm 

is running causes an error summary to be pr1nt«»(l. 

G124 -This is a seek test program. It causes the disk to 

perform random, maximum or incrementing seeks. Return 
through front panel Interrupt or by typing "R". 

G128 -G128 gets the size of the disk and displays it on 
the screen. The program assumes that controller 
firmware has been stored on trackO, head 0, sector 1. 

G12C -INITIALIZE USER AREA FROM lOOOH. This program is 

very similar to GUC in that both load the HDC user 
memory area. The difference is that G12C also loads 
track 0, head 0, sectors 1 and 2 with the same program. 
Programs that are loaded by 12C must have the same format 
as CPMUSER. 

G130 -RUN INTERFACE TEST. This routine tests the CPU/HDC 

Interface. This is achieved by sending data blocks to 
the HDC and reading them back. Three data patterns are 
used, a 00 pattern', FF pattern and a random pattern. 
Any errors are displayed on the screen. 

G134 -MEMTEST. This program tests the HDC RAM mmemory. For 
each test loop containing no errors, an 'OK' Is printed. 
The program first executes at 4100H and "tests COOOH 
to FFFFH. After 256 loops it moves itself to COOOH 
and tests 4100H to 7FFFH. If an error is found, the 
address, expected contents, and actual contents Is 
printed in hex. 

G138 -GETMEM. This routine retrelves the HDC read buffer 
(FOOOH to F3FFH) and moves It to 4000H in the host's 
memory. This allows examination of the header which 
is normally not returned by the HDC. 

G13C -READTHS. This routine reads until error the sector 
specified by TRACK, HEAD, and SECTOR. Get summary 
with "S" and exit with "R". 

G140 -WRITETHS. This routine writes, reads, and compares 
the sector specified by TRACK, HEAD and SECTOR 
until error. Get summary with "S" and exit with "R". 

6150 -RDISPC. Read and display continuously. This routine 
calls READISP below, increments the physical sector 
and repeats. Exit with "R". 

6154 -READISP. This routine reads the sector specified 
by TRACK, HEAD, and SECTOR and displays the first 
lOOH bytes. 
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G158 
G15C 
G160 



-GETBST. This routine reads the Bad Sector Table and 
displays 1t. Additional entries may be added, 

-ZROBST. This routine zeroes the Bad Sector Table. 
(G158 must be run Immediately before G15C). 

-COMP. Compares read and write buffers. Useful to 
locate byte in error after G140. 



ERROR MESSAGE FORMAT 



When G120 or some of the other test routines are running read and 
write errors are displayed with 6 numbers. They have the following 
meaning: 

ERROR TYPE, ERROR RETURN FROM HDC, TRACK, HEAD, SECTOR, DATA PATTERN 



ERROR TYPES: 00 
01 
02 

ERROR RETURN FROM HDC: 

80 
40 
21 
22 
23 
11 
12 
13 
14 
91 
92 



Write 

Read 

Compare (data different from expected result) 



Command Error 

Data CRC Error 

Could not find sector-1 (header) 

Bad track, head, or sector # in header 

Header checksum error 

Write fault 

Drive Not Ready 

Internal timeout 

Read after write compare error 

Error in saving first 17K during Format 

Error in restoring first 17K in Format 



